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A SYSTEM AND METHOD FOR CUSTOMIZING APPEARANCE AND 
BEHAVIOR OF GRAPHICAL USER INTERFACES 

BACKGROUND 

The present invention relates generally to graphical user interfaces for 
5 computer systems. More particularly, the present invention relates to systems 
and methods for interfacing applications and operating systems which provide 
for flexible customization of graphical user interfaces. 

The evolution of the computer industry is unparalleled in its rate of 
growth and complexity. Personal computers, for example, which began as little 

10 more than feeble calculators with limited memory, tape-driven input and 

monochrome displays are now able to tackle almost any data processing task. 
While this meteoric increase in power was almost sufficient to satisfy the 
demand of application programmers and end users alike, the corresponding 
increase in complexly created an ease-of-use problem which the industry was 

15 somewhat slower in solving. Thus, designers were faced with a new challenge: 
to harness this computing power in a form usable by even those with relatively 
little computer training to smooth the transition of other industries into a 
computer-based information paradigm. 

As a result, in the early to mid-1980's many new I/O philosophies, such 

20 as "user friendly", "WYSIWYG" and "menu driven" came to the forefront of 
the industry. These concepts are particularly applicable to microcomputers, 
also known as personal computers, which are intended to appeal to a broad 
audience of computer users, including those who previously feared and 
mistrusted computers. An important aspect of computers which employ these 

25 concepts was, and continues to be, the interface which allows the user to input 
commands and data and receive results, which is commonly referred to as a 
graphical user interface (GUI). 

One type of GUI display is based on a visual metaphor which uses a 
monitor screen as a work surface called a "desktop" where documents are 

30 presented in relocatable regions termed "windows". The user interacts with the 
.computer by, for example, moving objects on the desktop, choosing commands 
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from menus, and manipulating window controls, such as checkboxes and scroll 
bars. An exemplary desktop screen- is reproduced as Figure 1. 

The success of this type of interface is evident from the number of 
companies which have emulated the desktop environment. Even successful 
5 concepts, however, must continually be improved in order to keep pace with 
the rapid growth in this industry. The advent of multimedia, especially CD- 
ROM devices, has provided vast quantities of secondary storage which have 
been used to provide video capabilities, e.g., live animation and video clips, as 
regular components of application displays. With these new resources at their 

10 disposal, application designers, and others, desire more and more control over 
the appearance of the display, including the desktop environment and, in 
particular, objects on the desktop. 

Windows are one example of desktop objects which can be virtually any 
size, shape, or color. Some standard types of windows are conunonly 

15 predefined for the interface including, for example, a document window and a 
dialog box. One example of a standard for a document window is illustrated in 
Figure 2A. Each docimient window which conforms to this standard has a title 
bar with a title drawn in a system-defined font and color. Active document 
windows can also have controls as illustrated in Figure 2A, for example, a 

20 close box, a zoom box, a size box, and scroll bars. These standard types of 
windows (as well as other standard desktop objects) are beyond the reach of 
users who wish to alter the appearance and/or behavior. 

Accordingly, application developers can define their own nonstandard 
window types as desired, although each nonstandard window requires a 

25 relatively large block of memory. Further, even these nonstandard window 
types provide only limited flexibility and control over the appearance and 
behavior of desktop objects in that they are application-specific and do not 
present a consistent interface across all applications, i.e., if three different 
applications are running, each might present a different "look" on desktop. 

30 Once again, the user has no control over the appearance and/or behavior of 
these nonstandard window objects. 
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Since the window format, including the appearance, behavior and 
function of standard windows and window parts, is known a priori to 
applications which were designed for such conventional systems, these 
applications are written to take advantage of such knowledge. As seen in 
5 Figure 3, suppose, for example that an application 10 desires to draw a 

rectangle in the color of the title bar (beige, in this example) in a window (not 
shown on the desktop). The application assumes knowledge of the color of the 
title bar when using predefined standard window defmitions 25 and, if this 
application uses window definitions created by the application itself, the 

10 application will have actual knowledge of colors defined by those windows. 
Accordingly, the application will simply send a command to the interface 
instmcting that a beige rectangle be drawn in the window. 

Each standard window, as well as any nonstandard window, 
conventionally has a corresponding window definition 25. The window 

15 definition 25 includes all of the data necessary to define the window. looking 
at the active window illustrated in Figure 1, data included in the window 
definition 25 for such an active window would include, for example, the size of 
the window, the relative location of die close box and zoom box in the upper 
lefthand and rightfaand comers, respectively, the number of parallel lines and 

20 their locations relative to the close box and flie zoom box, and flie upper 

boundary of the window and all of the other defining features of that particular 
window. The application supplies the variable parameters such as the location 
of the window on the desktop interface and, perhaps, the colors and/or fonts to 
be used for the text and/or figures in the window. As one can imagine, the 

25 window definitions can include a large amount of data and, therefore, can 
require a large amount of mraiory for each definition. 

In addition to the amount of memory used to create non-standard 
window definitions, another problem with this conventional method of 
providing variety of appearance in the graphical user interface is the lack of a 

30 consistent appearance between objects drawn on the desktop by different 
applications. With multitasking i.e., multiple applications ranning 
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simultaneously on a desktop, it is now common for users to simultaneously mn 
multiple applications each of which has its own window on the desktop. 
However, if each application uses its own combination of standard and non- 
standard window definitions that result in each application having its own 
5 appearance and behavior. The dissimilarity in appearance and behavior 
between applications can be annoying and confusing to a user. 

Accordingly, it would be desirable to allow application designers and 
application users to have additional flexibility and greater control over the 
appearance and behavior of desktop objects and individual controls for those 
10 objects. 

SUMMARY 

According to exemplary embodiments of the present invention, an 
improved visual appearance can be provided to GUIs by providing an 
appearance management layer that gives users (both application developers and 

15 end users) the ability to customize the appearance and behavior of the desktop. 
This layer can be provided between all of the clients, e.g., applications, the end 
user, definition procedures, and the graphic subsystem which actually writes to 
the display. In this way, a level of abstraction is provided between the client 
and the system so that customization can be facilitated without requiring the 

20 client to have a detailed knowledge of the interface environment, which may be 
constantly changing. 

Themes can be created which include sets of desktop objects that are 
designed, both in their visual appearance and behavior, to project an overall 
impression to the area. The user can switch between themes, even at runtime, 

25 to change this overall impression. 



BRIEF DESCRIPTION OF THE DRAWINGS 

The foregoing, and other, objects, features and advantages of the present 
invention will be more readily understood by those skilled in the art upon 
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reading the following detailed description in conjunction with the drawings in 
which: 

Figure 1 shows a conventional desktop screen; 

Figure 2A shows a conventional document window; 
5 Figure 2B illustrates a document window according to an exemplary 

embodiment of the present invention; 

Figure 2C illustrates a conventional user interface; 

Figure 2D illustrates the user interface of Figure 2C operating under a 
theme according to an exemplary embodiment of die present invention; 
10 Figure 2E illustrates the user interface of Figure 2C operating under a 

second theme according to another exemplary embodiment of the present 
invention; 

Figure 3 illustrates a functional overview of a system for customizing a 
user interface according to an exemplary embodiment of the present invention; 
15 Figure 4 illustrates an exemplary architecture showing theme and 

application interaction according to an exemplary embodiment of the present 
invention; 

Figure 5 illustrates a set of glyphs which can be used to create a 
document window for a particular theme according to an exemplary 
20 embodiment of the present invention; 

Figure 6 is a state diagram used to illustrate transitions of an interface 
object part according to an exemplary embodiment of the present invention; 

Figure 7 is an exemplary matrix used to describe behavior transitions 
according to exemplary embodiments in the present invention; 
25 Figure 8 is a block diagram illustrating inheritance according to an 

exemplary embodiment of the present invention; 

Figure 9 is a block diagram which illustrates pattern abstraction 
according to an exemplary embodiment of the present invention; 

Figure 10 is a block diagram which also illustrates pattem abstraction, 
30 but according to another exemplary embodiment of the present invention; 
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Figure 1 1 illustrates an exemplary appearance control panel according to 
an exemplary embodiment of the present invention; 

Figure 12 illustrates an interaction between an appearance management 
layer, an application, and a theme according to an exemplary embodiment of 
the present invention; and 

Figures 13-15 are flowcharts which illustrate exemplary methods used to 
switch themes according to exemplary embodiments of the present invention. 

DETAILED DESCRIPTION 

The present invention is described herein by way of exemplary, 
illustrative embodiments, some of which use the Macintosh® computer system 
as a reference for explaining the present invention. However, those skilled in 
the art will readily appreciate that systems and methods according to the present 
invention can be applied to any type of display system having a user interface. 
Further, while window objects are used to illustrate how exemplary 
embodiments of the present invention affect the appearance and behavior of 
desktop objects in general, those skilled in the art will recognize that the 
present invention can be used to control the appearance and behavior of any 
desktop object including, for example, icons, menus, lists, control elements, 
cursors, menu bars, etc. 

Windows can be characterized in a variety of ways. For example, a 
window can be characterized by the shape, size and color of the window as 
well as by the location, size, shape and color of each of its component parts, 
e.g., those parts identified in Figure 2A. These attributes of a window and 
window parts are categorized herein as a window's appearance attributes. The 
window and its parts also have associated therewith one or more functions 
which are invoked when a user provides an associated iI^)ut, e.g., clicking on a 
close button or box causes the window to close. These are termed functional 
attributes. 

A third category of attributes also exists for some windows and window 
pans. These windows and window parts exhibit a behavior when acted on by a 
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user which is distinct from the underlying function of these objects, i.e., when 
a user clicks on a close button using a mouse, the button becomes shaded in 
such a way that it appears depressed prior to the window actually closing. 
Of these three attribute categories, namely appearance, behavior and 

5 function, exemplary embodiments of the present invention provide users (the 
term users as applied throughout this document refers to both end users of 
applications, application developers and other individuals who use or invoke 
operating systems) with the capability to alter the appearance and behavior of 
object and object parts, but preferably not the underlying function thereof. It 

10 will be understood by those skilled in the art that the principles described herein 
are equally applicable to systems and methods in which the functional attributes 
can also be varied by users. However, standardization of system functionality 
provides certain advantages so that exemplary embodiments of the present 
invention separate functional manipulation from manipulation of the other 

15 attributes. 

Given all of the graphical and audio artistry available today for GUIs, 
one can easily imagine the wide variety of desktop "looks" which can be 
developed once the system's control over the appearance and behavior of 
interface objects is relaxed. Comparison of flie conventional user interface 

20 screen shown in Figure 2C with user interface screens using different themes 

shown in Figures 2D and 2E is an excellent starting point toward understandii^ 
the powerful capabilities for appearance and behavior change in user interfaces 
according to the present invention. Note, for example, the difference in 
appearance between the "Views" title bar in Figure 2C as opposed to those of 

25 Figures 2D and 2E. 

An overview which sununarizes how these types of customized user 
interfaces can be provided in a consistent and switchable manner begins with a 
discussion of Figure 4. As shown, the application 38 interacts with the 
appearance management layer 40 through three paths: directly, through utilities 

30 42 (e.g.. Toolbox Managers), and through drawing procedures 46 which 

provide the fundamental instmctions» (e.g., defjprocs) for drawing objects on the 
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interface. The phrase "drawing procedure" as it is used in this document refers 
to pieces of code which are responsible for drawing interface objects and which 
define the shape of those objects, e.g., window definitions. 

Note that the application does not access the drawing procedures 
5 directly, but does so through a table of pointers 44 maintained by the 

appearance management layer and utilities. Switchable pointers 44 and drawing 
procedures 46 provide the basic building blocks which allow the geometry of 
each interface object as well as the behavior of each object's controls to be 
manipulated in a consistent and replaceable fashion. By switching the pointers 
10 44 to the drawing procedures 46, or by switching the data used by the 

procedures 46, the appearance and behavior of the interface can be readily 
changed. 

To provide the flexibility afforded by the present invention, applications 
no longer need to have a priori knowledge of the patterns or colors used for 

15 each object and its controls. Therefore, a pattern table 48 is used to look up 
this information and serves to abstract the color and/or pattern of the object 
from its other attributes. According to certain exemplary embodiments, 
drawing primitives which allow "paint-by-number" interface drawing are sent 
by the client to the appearance management layer. In other words, the 

20 application can simply command the appearance management layer 40 to draw 
an object using an index which identifies the pattern and/or color of that object, 
so that the visual geometry is abstracted from the colorspace and the application 
need not know which particular geometries and/or colors are currenfly being 
implemented. According to other exemplary embodiments, the pattern table 48 

25 acts as a pattern/color database and returns the relevant pattern information to 
the client. The client then instructs the graphic subsystem 56 to render the 
appropriate pattern. 

In order to provide the functionality to switch between themes, the 
theme switching 50 and ran time support 52 control interaction of the 

30 appearance management layer and the theme. As used herein, the terms 
"theme" and "themes" refer to coordinated designs of interface objects and 
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object parts that create a distinct visual appearance on the display. These 
routines provide mechanisms for loading and unloading themes and obtaining 
theme attributes. Various routines are also provided to support animation and 
sounds and handling desktop patterns and screen saver modules in the interface 
5 as shown generally by block 54. 

Switchable Pointers and Drawing Procedures 

Many of the objects which are drawn in the user interface are created by 
small, modular pieces of code in the system which are dedicated to a specific 
purpose, e.g., drawing window frames. These pieces of code, called drawing 

10 procedures or definition procedures (defprocs) herein, are designed for 
switching at run time to enable dynamic system appearance and behavior. 
While the procedure and mechanism for switching between themes is described 
in more detail below, this section focuses on exemplary ways in which these 
procedures are designed to provide a switchable routine environment. 

15 The appearance management layer 40 is responsible for orchestrating 

various changes which allow switching of the user interface's appearance and 
behavior. Two exemplary ways in which the drawing procedures can be 
switched will now be described here. 

According to certain exemplary embodiments, all of the utilities which 

20 support switchable drawing procedures will be called to "disconnect" all of the 
drawing procedures for each of the interface objects supported by that particular 
utility. In essence, this amounts to sending a dispose message to the drawing 
procedure for each and every utility object element currently in existence. The 
utility then is called to swap pointers 44 to the drawing procedures. For 

25 example, if window drawing procedure A is being replaced by window drawing 
procedure B, the window drawing utility will be asked to replace all of its 
references to procedure A with references to procedure B. This process will 
occur for each drawing procedure that is switched out. Lastly, every drawing 
procedure for every utility interface element should be sent an initialize 

30 message and the display will be completely redrawn. 
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According to other exemplary embodiments of the present invention, 
these drawing procedures can be data driven so as to allow each procedure to 
be able to support a wide variety of appearances and behaviors without 
modifying the code of the procedure itself. In this way themes can be switched 
5 without requiring that the drawing procedure code be switched. Each theme 
provides its own data stmctures which are supplied to the parametric drawing 
procedure. These exemplary embodiments will now be described in more 
detail. 

According to certain exemplary embodiments of the present invention, 
10 system-provided drawing procedures map directly from existing procedures to 
provide compatibility with existing systems. For example, each individual 
drawing procedure will correspond to a conventional procedure (e.g., WDEFO, 
WDEFl, CDEFO, CDEFl). This mapping can be accomplished, for example, 
by the exemplary mapping procedure illustrated below in pseudocode form. 
15 This exemplary procedure can handle loading both conventional drawing 
procedures as well as the new drawing procedures. 



OSErr MapDefprocReference(ResType defjprocType, SIntl6 defprocID, 

Handle *defprocHandle, SOMObject **ido) 

{ 

20 OSErr result; 

// 

// First load the defprocType, defprocID resource 
// 

*de]^rocHandle = GetResource(defiprocType.defprocID); 
25 // 

// If the resource came from the system, this identifies it as a stub 
and so get the corresponding ido pointer. 

// 

if (the Handle is a System Resource) 
30 { 

result = GetSystemIDO(defprocType,defprocID,ido); 

} 

else 
// 
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// If the resource didn't come from the system, assume it's a 
// custom resource deproc and return a NULL ido pointer. 

// 

{ 

5 result = noErr; 

*ido = NULL; 

} 

} 

The first step, as seen above, is to determine the resource ID of the 
10 procedure being called. This will load either an old style procedure located in 
a resource chain or a stub resource from the system file. Stub resources are 
modules which, when invoked, decode a conventional procedure's message and 
call the corresponding new drawing procedure based on the decoded message. 
Thus, when a utility creates a new interface object using a drawing procedure it 
15 will also load an appropriate stub resource and store its value in a procedure 
handle field of the object's data stracture. Since the utilities can switch the 
drawing procedure that they call, the ability to dynamically change the set of 
drawing procedures which create the interface objects is now available. 

According to other exemplary embodiments of the present invention, the 
20 drawing procedures can be parametric in nature so that they need not be 

switched every time that a theme is changed. Instead, the data supplied to these 
procedures is changed with the theme. A discussion of these exemplary 
embodiments begins with a- description of the data used to drive these 
procedures. 

25 The data structures which are used to drive the structural procedures 

according to this exemplary embodiment of the present invention can be 
categorized as interface geometry elements data and interface behavior elements 
data. An object geometry is specified by a list of arbitrary geometry objects 
that are linked together with a simple rule based view system. Each of the 

30 geometry objects are arbitrary in size and shape and may repeat in either a 

horizontal or vertical direction. Drawing procedures such as window drawing 
procedures (e.g., WDEFs), and menu drawing procedures (e.g., MDEFs), can 
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use these geometry resources to calculate and draw the structure region of an 
interface object, e.g., a window or a menu. 



TABLE A 


Opcodes 


Specify edges of glyphs in object 
by offsets. 


Glyph Ust 


Points to data structure for each 
glyph. 


Geometry Part List 


Combines glyphs with boundaries. 


Existence State 
Table 


All boundaries and geometry parts 
indicate when they exist in the 
object. 



The resources that define this geometry model can be broken into four 

10 parts as seen in Table A, above. First, there are a list of operation codes 

which place horizontal and vertical boundaries that will be used to specify the 
edges of glyphs in the object. Each boundary can be placed relative to a 
reference, which is either part of a parent shape (e.g., a rectangle that defines a 
window's, or other object's, workspace) or a previously defined boundary. The 

15 offset can either be a constant or some other value recognized by the system, 

such as the height of a window's title. As each boundary is placed, a limit can 
be specified such that the new boundary will fall between the limit boundary 
and the reference boundary. Limit boundaries allow geometry elements to 
disappear when the parent shape becomes too small to support them. 

20 Second, a geometry resource can also contain a list of glyphs. Each 

glyph can be derived from a pattern of pixels, a bitmapped image or an icon. 
Moreover, each glyph can also specify on which comer it is anchored to allow 
it to be drawn in the correct direction. 

Third, there can be a list of geometry parts each of which combine one 

25 of the glyphs with two horizontal and two vertical boundaries. For each type 
of interface object, there may be both required and optional parts. For 
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example, a window may be required to have a close box or button part but may 
also include many optional parts that are used to enhance the appearance of the 
window. 

Finally, all boundaries and parts can specify in which states they exist. 
5 For example, a close box part and perhaps one or more of its boundaries might 
not exist in the inactive state of a window. This y specification reduces the 
amount of computation and drawing that is done in any particular state. Each 
interface element has a predefined set of states that may be used when 
traversing the geometry resources. Another use for this mechanism is to 

10 change the appearance of a part in a special state of the object. For example, 
to change the appearance of a window's bottom edge when the glyph is 
deactivated, two bottom edge parts can be defined that use different glyphs. 
One of these parts might exist only when the window is active, the other when 
the window is inactive. An exemplary table of glyphs appended as Figure 5 

15 illustrate a set of glyphs which can be used to render a document window in an 
exemplary theme as shown in Figure 2B. The horizontal and vertical 
boundaries are constructed so as to locate all of these glyphs around the content 
shape of the window to produce the desired look for this theme. 

The second category of data structures used in the data driven structural 

20 procedure relate to interface objects* behaviors. Each behavior is associated 
with transitions between different states or values of controls in the interface 
and can be expressed by changes in visual or audio output that correspond to 
these transitions. 

Data driven drawing procedures can use a common mechanism that 
25 implements state tables. These state tables contain bitmaps or glyphs for each 
state of the control represented thereby as well as information about transitions 
from one state to another. Each transition may contain one or more of, for 
example, an animation sequence, a sound or a routine to implement a custom 
transition, e.g., an algorithmic display or any other type of transitional effect. 
30 By defining state diagrams for each object and object part of the user interface, 
a template can be created that allows a theme designer to place customized 
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glyphs for each state of the control and also to customize the transitions 
between states of the control as desired. An exemplary state diagram is shown 
as Figure 6 which provides an example of the possible states and most common 
state transitions for a checkbox control of a window object. 
5 As seen in Figure 6, this exemplary checkbox has nine possible states 

which can be displayed. These states include three highlighted states for each 
of the control's three values. In normal use, when a user clicks on an 
unchecked checkbox (state Ql), this action moves the control to its pressed 
state (state Q4). After the mouse is released, the control returns back to its 

10 original state (state Ql) and the appUcation is notified of the button which has 
been pressed. The application then switches the value of the control to its new 
value, which might be checked (state Q2). 

In data driven themes according to the present invention, a resource 
exists for each of the customizable controls to allow the theme designer to plug 

15 in new glyphs or bitmaps for each of the states of the control. Moreover, to 
provide more flexibility to customize transitions between states and a control 
state table, a matrix for these transitions can be provided. Note for example 
the exemplary matrix illustrated in Figure 7. For each block in the matrix, a 
theme designer can provide a visual and/or audio output such as an animation, 

20 sound, a custom transition procedure which can perform some type of 

algorithmic transition, e.g., a kaleidoscopic display or any combination thereof. 
Of course, not every box in the transition matrix need be filled in by the theme 
designer and where no transition behavior is specified, or if the theme does not 
specify a special transition behavior, the control moves directly to the glyph or 

25 bitmap that is specified for the new state without any transitional effect. 

Although the foregoing two exemplary embodiments describe switching 
either the code or the data of the drawing procedures, those skilled in the art 
will appreciate that both schemes can be implemented in the same interface. 
For example, it may be advantageous to generate certain themes, e.g. , themes 

30 using relatively simple patterns, by way of hard-coded drawing procedures to 
provide a speedy redrawing of the interface. Similarly, where a theme is, for 
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example, relatively more complicated graphically, it may be advantageous to 
generate such themes using the aforedescribed data-driven drawing procedures. 
Accordingly, since many different types of themes are available for user 
selection, it is anticipated that both of the above-described exemplary 
5 embodiments can be deployed in the same interface and the switchable pointers 
will then either point to the appropriate hard-coded procedure or to the 
parametric drawing procedure. 

Custom drawing procedures can inherit from the system provided 
appearance using a form known as delegation or forwarding. Delegation 

10 involves passing control on to another object when inherited behavior is 

desired. To determine the particular object to which the drawing procedure 
should delegate in a dynamically changing interface, either the client can call in 
to the system or the system can track current implementations. According to 
exemplary embodiments, this burden can be placed on the system by providuig 

15 an additional layer of redirection. As seen in Figure 8, the utility 61 calls the 
custom drawing procedure 63. The drawing procedure 63 inherits from the 
switcher 65 which delegates to the appropriate implementation 67 or 69. An 
example of this type of inheritance will now be described using menu drawing 
procedures. 

20 A theme can provide a nienu drawing procedure which controls drawing 

standard menus for that theme. While many applications have customized 
menu items, a theme may only change the appearaiKre or behavior of a single 
item in the menu while letting the remaining menu items appear and behave as 
they do when the system default theme is in control. By creating a custom 

25 menu drawing procedure that inherits from the systeni menu drawing 

procedure, i.e., from the switcher object, the application can intercept the 
command to draw a menu item from the utility issuing the command. If the 
menu item to be drawn is an item whose appearance and/or behavior has been 
customized by the theme, then the theme's menu drawing procedure can be 

30 used to draw that item. Otherwise, the inherited code pointed to by the 
switcher object can be called to draw the item. 
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In this particular example, where the theme only customizes one menu item, the 
theme's custom menu drawing procedure only overrides the system to draw that 
item, with any other items being drawn using the inherited codeA 

Pattern Look-up Tables and Drawing Support 
5 The following is a more detailed description of the pattem look-up table 

mechanism 48. As described above, since one of the objects of the present 
invention is to provide interfaces which facilitate user control over the 
appearance of the desktop, the themes used by the appearance management 
layer 40 should be able to operate on a variety of color data to draw the 

10 interface, e.g., a color pattem, a pattem defined on a pixel-by-pixel basis, 
bitmapped image or the like, etc. The pattem tables provide a system and 
method for specifying this color data, so that the theme color set can be edited 
independently of the theme using resource-editing utilities. The pattem tables 
provide this support by abstracting the notion of pen pattem and color, allowing 

15 an application or theme to draw interface pieces without being locked to a 
particular color set. 

This functionality is provided according to exemplary embodiments of 
the present invention by a mechanism including a pattem look-up table. An 
index in a pattem look-up table references data for a color, a pattem defined on 

20 a pixel-by-pixel basis, bitmapped image or the other data, so that the client 
need not know anything about the datatype contained in the pattem look-up 
table entry. The significance of this data independence is that a theme having 
solid-colored windows, for example, can be changed to instead draw the 
windows in a complex pattem, without changing the thane source code simply 

25 by editing the table entries. When reference is made below to the terms 

"pattem" or "patterns", it is intended to denote any type of graphic data that 
can be used in a pattem look-up table to draw in a graphics pon. As such, this 
may be a solid color defined in terms of its red, green and blue (RGB) 
components, or a pattem defined on a pixel-by-pixel basis, e.g. a PixPat, or a 

30 new type of data. 
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Before discussing the various features of the pattern table routines in 
great detail, an overview of how color and pattern abstraction can be provided 
according to an exemplary embodiment will be described with reference to 
Figure 9. Therein a client 60 sends a command ThemeFillRect (kColorlndex) 

5 to the appearance management layer. This command is one of a set of drawing 
primitives implemented by the appearance management layer 40. In this 
particular example, it is a command to draw a rectangle that is filled with the 
pattern specified as kColorlndex. The value of kColorlndex corresponds to a 
predetermined object or object part on the desktop. For example, index 3 

10 might correspond to the window title color. However, note that the client 60 
need have no knowledge of the particular color which is currently being 
implemented as the window title color, but only the absolute index which 
identifies that color. The kColorlndex parameter has a corresponding 

entry in the part index table 62. This entry maps into the theme pattern look-up 

15 table 64. As described previously, the entries in the theme pattern look-up 
table 64 can include any type of color or pattern data in any format. For the 
purposes of this example suppose that the entry in the part index table 
corresponding to the value of kColorlndex maps into a pattern called 'xpat' 
referring to a black and white criss-cross pattern. *Xpat* has a corresponding 

20 entry in the pattern defmition procedure table 66 where the procedure for 

drawing this black and white criss-cross pattern is located. This table includes 
a procedure pointer 68 which translates the conunands defined by the 'xpat' 
record into commands which are recognized by the graphic subsystem 56 used 
by the system to draw the pattem onto the display. These conmiands are then 

25 sent to the graphic subsystem which displays the pattem at the appropriate point 
on the desktop interface. 

Although the exemplary embodiment illustrated in Figure 8 portrays the 
client as using drawing primitives to send commands through the appearance 
management layer to the graphic subsystem, other exemplary embodiments of 

30 the present invention operate in a somewhat different fashion. According to 
this exemplary embodiment, the appearance management layer 40 does not 
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command the graphic subsystem 56, but simply acts essentially as a 
pattem/color database. For example, in the exemplary block diagram of Figure 
10, a get theme pattem command is sent to the appearance management layer 
40, instead of the drawing primitive in Figure 8. The appearance management 
5 layer returns a pattem structure which can be rendered by the graphic 

subsystem in the currently implemented theme for the particular interface object 
or object part requested in the get theme pattem command, to the client which 
then sends its own command to the graphic subsystem to draw the appropriate 
pattem and/or color on the desktop interface. This alternate exemplary 

10 embodiment also has the benefits described herein with respect to abstracting 
the pattem/color combination from the interface. 

Thus, through the use of pattem tables, the color and/or pattem of 
desktop objects can be readily switched from one theme to another by changing 
the values in the part index table 62 and/or the pattem look-up table 64. This 

15 switching of patterns is totally transparent to the application. As a result, new 
patterns can be added without any need to change the application itself. Having 
now described an overview of pattem and color abstraction according to the 
present invention, a more detailed description of exemplary routines for 
implementing the above will now be provided. 

20 The appearance management layer, according to certain exemplary 

embodiments, recognizes a set of drawing primitives which can be, for 
example, derived from those used by the system's graphic subsystem (for 
example, QuickDraw). These primitives can have the same calling sequence as 
their counterparts in the graphic subsystem, but use indices into the theme 

25 pattem table to specify the color and/or pattem details of the requested drawing 
command. Exemplary drawing primitives are illustrated below along with 
descriptions in italics. 

typedef unsigned char OSType [4]; 
typedef short SIntl6; 
30 typedef unsigned shon UIntl6; 
typedef unsigned long UInt32; 
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typedef UIntl6 ThemePartlndex; 

pascal OSErr ThemeSetPen (ThemePartlndex); 

Sets the pen pattern to the contents of the specified index of the theme pattern 
look-up table. 

5 pascal OSErr ThemeFrameRect (ThemePartlndex, Rect *r); 

pascal OSErr ThemeFillRect (ThemePartlndex, Rect *r); 
Fills or frames the rectangle with the contents of the specified index. 

pascal OSErr ThemeFrameRoundRect (ThemePartlndex, Rect *r, radius); 
pascal OSErr ThemeFillRoundRect (ThemePartlndex, Rect *r, radius); 
10 Fills or frames the round rectangle with the contents of the specified pattern . 

index. 

pascal OSErr ThemeFrameOval (ThemePartlndex, Rect *r); 

pascal OSErr ThemeFillOval (ThemePartlndex, Rect *r); 

Fills or frames the oval with the contents of the specified pattern irulex. 

15 pascal OSErr ThemeFramePoly (ThemePartlndex, PolyHandle); 

pascal OSErr ThemeFillPoly (ThemePartlndex, PolyHandle); 

Fills or frames the polygon with the contents of the specified pattern index. 

pascal OSErr ThemeFrameRgn (ThemePartlndex, RgnHandle); 
pascal OSErr ThemeFillRgn (ThemePartlndex, RgnHandle); 
20 Fills or frames the region with the contents of the specified pattern index. 



The appearance management layer can also define a set of bevel, text 
and dialog grouping rectangle primitives which can be used by clients for 
drawing bevels and dialog group rectangles in a standard appearance. The 
implementations of these routines can be overridden by the theme to generate 
25 special appearances. For this reason, the client should not draw bevels 
independent of the appearance management layer for user interface object 
parts, but should instead use the provided primitives. Exemplary primitives 
are shown and described below. 



pascal OSErr ThemeDrawBevel (Rect *pBevelRect, Boolean fbutton); pascal 
30 pascal OSErr ThemeDrawInsetBevel (Rect *pBevelRect. Boolean fbutton); 
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Draws a bevel into or out of the background. Iffbutton is set, then the bevel 
comers are left out, resulting in a standard 'beveled button" visual. 

pascal OSEiT ThemeDrawDeepBevel (Rect *pBevelRect, Boolean fbutton); 
pascal OSErr ThemeDrawDeepInsetBevel (Rect *pBevelRect, Boolean fbutton); 
5 Draws a deep bevel into or out of the background, 

pascal OSErr ThemeDrawInsetTextFrame (Rect *pTextFrame); 

Draws the standard inset text frame which is used for edit text items in dialogs. 

pascal OSErr ThemeDrawRidge (Rect *pRidgeRect); 
pascal OSErr ThemeDrawInsetRidge (Rect *pRidgeRect); 
10 Draws a ridge frame into or out of the surface. 

pascal OSErr ThemeDrawEmbossedString (StringPtr, scriptcode); 
pascal OSErr ThemeDrawInsetString (StringPtr, scriptcode); 
Draws a string embossed out of, or inset into, the surface. 

pascal OSErr ThemeDrawShadowedString (StringPtr, scriptcode); 
15 Draws a string with a shadow. 

pascal OSErr ThemeMeasureBnbossedString (StringPtr, scriptcode, Rect); 
pascal OSErr ThemeMeasurelnsetString (StringPtr, scriptcode, Rect *); 
pascal OSErr ThememeasureShadowedString (StringPtr, scriptcode, Rect); 
Measure the size of the string when embossed. 

20 pascal OSErr ThemeDrawGroupingRect (Rect *pGroupRect, Str255grouptitle); 

Draws a dialog item groi4ping rect with the specified title. An empty or nil 
title may be passed and no title will be drawn. 

pascal OSErr ThemeDrawSeparatorLine (Intl6 length. Boolean fvertical); 
Draws a horizontal or vertical separator line. 



25 Pattern look-up tables are provided as part of the package which 

handles drawing requests, either with the aforedescribed drawing primitives 

or alone, which tables will now be described in somewhat more detail. 

A pattern data structure holds the data necessary to draw a pattern. It 

can have, for example, the following structure: 

30 typedef UInt32 PattemData [2]; 

typedef PattemData *PattemDataPtr; 
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The pattern data structure can be, for example, an eight-byte structure used 
to store pattern and/or color information. If the data required for the pattem 
is more than eight bytes long, it can be stored in a handle and the handle 
placed in the pattem data stmcture. A pattem definition procedure, 
5 described below, is a component which is responsible for the loading and 
interpretation of a pattem data stmcture. 

The pattem look-up table specifies the list of colors and patterns used 
by a theme. A pattem look-up table contains a list of records, e.g., Pattem 
Spec record 'xpat' in Figure 9, each of which is typed and references a 

10 specialized procedure to load, unload and draw. 

Data encapsulation within a pattem look-up table entry is 
accomplished through use of a pattem definition procedure, a code module 
responsible for loading, unloading and interpreting a pattem look-up table 
entry's data, e.g., the pattem definition procedure 'xpat' of block 66 in 

15 Figure 9. New pattem types may be defined by a theme for specific needs, 
such as algorithmic color and pattem generation, simply by adding new 
pattem definition procedures. A pattem definition procedure can be defined, 
for example, as a code fragment module or a dynamically loaded library 
which exports a list of entrypoints as set forth below. The default behavior 

20 for unimplemented entiypoints is to return an error. 

OSErr PatDefOpen (OSType *pPattemType); 

Called when the pattern def is initialty loaded, to allow the procedure 
to initialize state data, *pPattemType should be set to an OSType denoting 
the pattem type it will handle, for example 'xpat' or 'ppat\ 



25 OSErr PatDefClose 0; 

Called when the pattem def is no longer needed, to allow release of 
state data, 

OSErr PatDeflLoadData (PattemDataPtr, Intl6 id, Intl6 index); 
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Load the data associated with this pattern from a resource, and place 
the data in the PattemData record pointed to by PattemDataPtr. 

OSErr PatDefSetData (PattemDataPtr, PattemDataPtr newdata); 
Set the pattern data to a copy of that located in newdata. 

5 OSErr PatDefFreeData (PattemDataPtr); 

Free the data in the PattemData record pointed to by PattemDataptr. 

OSErr PatDefSetPen (PattemDataPtr); 
Set the port's pen to draw with the pattern. 

OSErr PatDefFrameRect (PattemDataPtr, Rect *); 
10 OSErr PatDefFUlRect (PattemDataPtr, Rect *); 

Fill or frame the rectangle, 

OSErr PatDefFrameRoundRect (PattemDataPtr, Rect *, UIntl6 w, UIntI6 h); 
OSErr PatDefFillRoundRect (PattemDataPtr, Rect *, UIntl6 radius); 
Fill or frame the rounded rectangle. 

15 OSErr PatDefFrameOval (PattemDataPtr, Rect *prect); 

OSErr PatDefFUlOval (PattemDataPtr, Rect *prect); 
Fill or frame the oval contained in the rect. 

OSErr PatDefFramePoly (PattemDataPtr, PolyHandle hpoly); 
OSErr PatDefFillPoly (PattemDataPtr, PolyHandle hpoly); 
20 Fill or frame the polygon. 

OSErr PatDefFrameRgn (PattemDataPtr, RgnHandle rgn); 
OSErr PatDefFillRgn (PattemDataPtr. RgnHandle rgii); 
Fill or frame the Range. 
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Pattern look-up tables may be created in memory by applications to allow them 
the benefits of a pattem look-up table within the application. An exemplary 
application program interface (API) for creating pattem look-up tables is described 
below. 

5 typedef void *PattemTableRef; 

typedef UIntl6 Pattemlndex; 

pascal OSErr NewPattemSpecTable (PattemTableRef*); 
pascal OSErr DisposePattemSpecTable (PattemTableRef); 
Creates and Disposes a PattemSpecTable. 

10 pascal OSErr AddPattemSpecToTable (PattemTableRef, OSType pattemkind, 

PattemDataPtr pdata, Pattemlndex *pindex); 

Adds a new pattem spec to a PattemSpecTable. Patterns are always added to 
the end of the table. The index at which the pattem is placed is retumed in pindex. 

pascal OSErr GetPattemlndexType (PattemTableRef, Pattemlndex, OSType 
15 *pattemkind); 

Returns the type of pattem located in the specified index of the table. 

pascal OSErr SetPattemSpecData ( PattemTableRef, Pattemlndex, OSType 
pattemkind, PattemDataPtr pdata); 

Set the pattem spec at the specified index to contain the specified data. 

20 pascal OSErr PattemTableSetPen (PattemTableRef, Pattemlndex); 

Sets the pen pattem to the contents of the specified index of the theme pattem 
look-up table. 

pascal OSErr PattemTableFrameRect (PattemTableRef, Pattemlndex, Rect *r) 
pascal OSErr PattemTableFillRect (PattemTableRef, Pattemlndex, Rect *r); 
25 Fills or frames the rectangle with the contents of the specified index. 

pascal OSErr PattemTableFrameRoundRect (PattemTableRef, Pattemlndex, 

Rect *r, radius); 

pascal OSErr PattemTableFillRoundRect (PattemTableRef, Pattemlndex, Rect 

*r, radius); 

30 Fills or frames the round rectangle with the contents of the specified pattem 



index. 



pascal OSErr PattemTableFrameOval (PattemTableRef, Pattemlndex, Rect *r); 
pascal OSErr PattemTableFillOval (PattemTableRef, Pattemlndex, Rect *r) 
Fills or fi^ames the oval with the contents of the specified pattem index. 



wo 95/31775 



PCT/US95/06175 



- 24 - 

pascal OSErr PattemTableFramePoly (PattemTableRef, Patternlndex, 

PolyHandle); 

pascal OSErr PattemTableFillPoly (PattemTableRef, Patternlndex, 

PolyHandle); 

5 Fills or frames the polygon with the contents of the specified pattern index. 

pascal OSErr PattemTableFrameRgn (PattemTableRef, Patternlndex, 

RgnHandle); 

pascal OSErr PattemTableFillRgn (PattemTableRef, Patternlndex, 
10 RgnHandle); 

Fills or frames the region with the contents of the specified pattern index. 

, Themes can also define new pattern types to take advantage of special 
theme-specific behavior, such as algorithmically defmed patterns. To do 
this, the theme provides a resource defining the pattern type or registers a 

15 code fragment module or dynamically loaded library using, for example, the 
InstallPattemDefinition command described below. The pattern definition 
procedure will be added to the internal type list of the system, and will be 
called directly to load, unload and draw patterns of the corresponding type. 
This code can be stored as a code fragment module or dynamically loaded 

20 library, and remains loaded as long as there are pattern look-up table entries 
which reference its type. For this reason, pattern definitions can remain 
installed even after the theme which created the pattem is unloaded in case 
these definitions are used by other applications. 

pascal OSErr InstallPattemDefinition (ConnectionID 
25 cftnConnection); 

Install the specified pattem definition in a pattem handler list. If a 
handler for that type has already been installed, an error is returned. The 
pattem definition 's type (as returned by PattemDefGetType) should be 
unique, and the PattemDef is locked and loaded in the system heap. 

30 When a pattem definition procedure is installed, it can be added to an 

internal pattem definition table. For speed, these pattem definition 
procedures can be referenced by index rather than type in the pattem look-up 
table. When a new pattem is added to the pattem look-up table, the pattem 
definition table is scanned and the index of the definition for the pattem type 
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is inserted into the record for the new pattern. As new types are added, they 
can be added at the end of the list. 

When a new pattern definition procedure is added to the internal 
pattern definition table, a list is built which includes the exported pointers 
5 contained in the pattern definition. If any standard pointers are not defined, 
they are set to a default pointer which simply returns an unimplemented 
error. As discussed above with reference to Figure 9, when a pattern is 
drawn, the pattern is found in the pattern look-up table and its corresponding 
pattern definition procedure is located, then the desired function pointer is 
10 called. 

An example of a pattern definition procedure is shown below, which 
procedure is used to get a pattern defined on a per pixel basis from the look- 
up table and command the graphic subsystem to draw same. 

// structure for interpreting contents of our PattemData struct 
15 typedef stract 



PixPatHandle hPixPat; 



UInt32 unused; 
} 

PixPatData, *PixPatDataPtr; 



// PattemData struct is 8 bytes, pad to fit 



20 



OSErr PatDefOpen (OSType *pPattemType) 

{ 

*pPattemType = 'ppat'; // return type 



*pRefCon = (RefCon) 0; // no refcon used 



25 



return noerr; 



} 



OSErr PatDefClose 0 
{ 



return noerr; 



30 



} 
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OSErr PatDefLoadData (PixPatDataPtr *pdata, InU6 id, Intl6 index) 

pData->hPixPat = GetPixPat (id); 
if (pData->hPixPat == nil) 
5 renim MemErrorO; 

return noeix; 
> 

OSErr PatDefFreeData (PixPatDataPtr *pdata) 
{ 

10 DisposePixPat ^Data->hPixPat); 

return noerr; 

} 

OSErr PatDefSetData (PixPatDataPtr *pdata, PixPatDataPtr *pNewData) 

15 if (IpData- > hPixPat) 

{ 

NewPixPat (&pData- > hPixPat); 
if (IpData- > hPixPat) 
return QDError 0; 
20 CopyPixPat (pNewData- > hPixPat, pData- > hPixPat); 

return noerr; 

} 

OSErr PatDefSetPen (PixPatDataPtr *pdata) 
{ 

25 PenPixPat (pData->hPixPat); 

letum noerr; 

} 

OSErr PatDefFrameRect (PixPatDataPtr *pdata, Rect *prect) 

30 FrameCRect CpE>ata->hPixPat); 

return noerr; 

> 

OSErr PatDefPillRect (PixPatDataPtr *pdata, Rect *prect) 

35 FillCRect (pData->hPixPat); 

return noerr; 

} 
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The appearance management layer also defines a range of common 
pattern indices that can be included in each theme's pattern look-up table so 
that these indices are available to all clients. These include the set of 
patterns used to generate bevels and groups, along with other useful patterns, 
5 for example, the current background of the menu bar. The current 

background of the menu bar index may be passed to one of the standard 
theme drawing routines to draw shapes in the menu bar color. Below, for 
illustration purposes, an exemplary set of such common pattern indices is 



defined. 



10 



enum { 

// standard beveling colors 
kBevelBackgroundlndex — 0, 



20 



15 



kfievelFramelndex, 

kBevelFacelndex, 

kBevelShadowIndex, 

kBevelHilitelndex , 

kBevelComerlndex, 

kBevelAuxShadowIndex, 

kBevelAuxHilitelndex, 

kBevelAuxComerlndex, 

kBevelHiliteComer, 

kBevelShadowComer, 



25 



30 



kInvBevelFramelndex, 

kInvBevelFacelndex, 

kInvBevelShadowIndex, 

kInvBevelComerlndex, 

kInvBe velHilitelndex , 

kInvBevelAuxShadowIndex, 

kInvBevelAuxComerlndex , 

kInvBevelAuxHilitelndex, 

kInvBevelHiliteComer, 

klnvBevelShadowComer, 



// text frames 
kTextFrameFilUndex, 



35 



kTextFrameFramelndex, 
kTextFrameHilightlndex, 
kTextFrameShadowIndex, 
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// standard ridge and group indices 
kGroupHilightlndex, 
kGroupShado windex , 
kGroupComerlndex, 
5 kOroupTextlndex, 

kRidgeHilightlndex , 
kRidgeShadowIndex, 
kRidgeComerlndex , 
kRidge AuxComerlndex , 

10 // beveled - shadowed text 

kTextlndex, 
kTextShado windex , 
kTextHilightlndex, 
kTextComerlndex , 

15 // custom 

kThemeCustomRangeStart =16384 

}; 

typcdef UIntl6 ThemePattemlndex; 

In addition to these exemplary defined types, a theme may define 

20 additional types which are used internally. These additional types can be 

indexed sequentially starting from whatever next highest index is available, 

e.g., 16384 in the example given above. 

The following illustrates three exemplary pattern types which can be 

defmed for usage in the appi^arance management layer. Therein, the 

25 command RGBColor specifies a red, blue or green color combination with 

which to draw an object or object part. CoIorPattem describes a two-color 

8x8 pixel pattern with a fore and backcolor, each specified with an 

RGBColor, An exemplary definition of a CoIorPattem type is shown below: 

typedef struct 
30 { 

RGBColor forecolor; 
RGBColor backcolor; 
Pattern pattern; 

} 
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10 



A PixPat type specifies an arbitrary pattern defined on a per-pixel basis, 
wherein a designated area may be filled or drawn with the pattern contents 
by the graphics subsystem. The PixPat (Pixel Pattern) data stmcmre is 
defined by the graphics subsystem, and is used to contain this per-pixel 
pattern. 

Themes provide a set of standard pattern look-up resources for use by 
the appearance management layer which are described below. The pattern 
lookup table defmes the set of colors and patterns used by the theme and is 
used to build the theme's pattern look-up table. The part index table maps 
the set of standard theme pattern indices into the pattern look-up table. An 
exemplary implementation of a PattemLookupTable and a PartlndexTable is: 



#defme kPatRGBKind 'clut' 
#defme kPatPixPatKind 'ppat* 
#define kPatColorPatKind 'cpat' 

15 // Pattern Lookup Tables 

typedef struct 
{ 

OSType pattemKind; 



20 



25 



SIntl6 pattemID; 
UIntl6 index; 

UInt32 pattemData [2]; 

} 

PattemLookupTableEntiy ; 

typedef struct 
{ 

UIntl6 numEntries; 



//color lookup table id -h index 
//PixPat id 
//ColorPattem id 



// kind of pattern, ie. kPatRGBKind 

// pattern resource identifier 
// index within resource 

// pattern data holder when loaded 



// count of entries in table 



PattemLookupTableEntry entries □; 
} 

PattemLookupTable ; 



// array of entries 



30 // Part Index Tables - maps a ThemePattemlndex into a Pattern Lookup Table 
typedef struct 
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{ 

ThemePatternlndex index; // corresponding ThemePatternlndex 

Ulntie plutlndex; // PatternLookupTable index 

5 PartlndexEntry; 

typedef struct 
{ 

UIntl6 numEntries; // count of entries in table 

PartlndexEntry entries []; // array of entries 

10 } 

PartlndexTable; 

As mentioned earlier, other exemplary embodiments of the present 
invention provide for pattern/color abstraction by returning information to 
the client rather than the appearance management layer conmianding the 

15 graphic subsystem directly. According to these embodiments, the client will 
ask the appearance management layer for a stmcture, e.g., a PixPat 
stmcture, corresponding to a specified index and will receive a handle that 
will allow the application to make the appropriate drawing call to the graphic 
subsystem 56. An example for this embodiment is illustrated below in 

20 pseudocode: 



typedef stmct 
{ 

UInt32 data [2]; // data block for pattern definition use 

} 

25 PattemData; 

OSErr PattemDefOpen (); 

Opens the pattern definition, initializing any global state data. The pattern 
defmay return an error code to veto loading (for example if the pattern def 
cannot run on the current system configuration). 

30 OSErr PattemDefClose (); 

Closes the pattern definition and frees any global state data. This is called 
prior to termination of the pattern def*s connection. 
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OSErr PattemDefGetKind (OSType *pKmd); 

Returns the pattern kind identifier. This is invoked by the appearance 
management layer to find the link to entries in the pattern table. 

OSErr PattemDefLoadData (PattemData *pData, SIntl6 resid, UIiitl6 

5 index); 

Loads the pattern data firom a resource^ based upon the resource id -h index. 

OSErr PattemDefCloneData (PattemData *pData, PatData *pCopy); 
Clones the pattern data contained in the PatData record and places the 
result in "^pCopy, 

10 OSErr PattemDefSetData (PattemData *pData, PatData *pNewData); 
Sets the pattern data to a copy of that contained in "^pNewData. 

OSErr PattemDefUnloadData (PattemData *pData); 
Frees the data stored in the pattern data record. 

OSErr GetPattcmPixPat (PatData *pData, PixPatHandle *hPixPat); 
15 Returns the PixPat represented by the pattern data, 

OSErr ApplyShapeStyle (PatData *pData, GXShape shape); 
Modifies the state of the GX object so that it draws in the desired style. This 
may include creating ink, transform or other style objects and linking them to 
the shape, or modifying the shape itself 

20 Another example of how a client would interact with the pattem look- 

up tables 48 according to these exemplary embodiments is illustrated below. 
OSErr NewPattemTable (PattemTable *table); 

Creates a new pattem table. 

OSErr GetNewPattemTable (SIntl6 resID, PattemTable *table); 
25 Gets a new pattem table from a resource, 

OSErr DisposePattemTable (PattemTable *table); 
Dispose a pattem table. 

OSErr GetPattemDef (<PattemDef Reference > . SOMObject 
*pattemDefObject); 
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Load a pattern definition proc and return its SOM Object. 

OSEiT AddPattemDefToTable (PatternTable table, SOMObject 
pattemDefObject) ; 

Add the pattern definition proc to the table. 

5 OSErr PattemTableSeflndexData ( 

PanemTable table, UIntl6 index, OSType kind, PauemData *pData); 
Set the data record associated with the table index. 

Application Pattern and Style Queries 

OSErr ThemeGetPartPixPat (PartCode part, PixPatHandle *partPixPat); 
10 Gets the PixPat associated with the part code. 

OSErr Theme ApplyPartStyleToShape (PartCode part, GXShape shape); 
Sets the style of the GXShape to the part style. 

OSErr PattemTableGetPixPat ( 

PatternTable table, UIntl6 index, PixPatHandle *hPixPat); 
15 Gets the PixPat associated with the table + index. 

OSErr PattemTableApplyStyleToShape ( 

PatternTable table, UIntl6 index, GXShape shape); 
Sets the style of the GXShape to that associated with the table + index. 

OSErr ThemeGetPartSeed (UInt32 *seed); 
20 Returns the seed for the theme pattern table. The seed is updated when 
changes are made to the pattern table which may invalidate cached 
PixPatsHandles. 

OSErr PattemTableGetSeed'(UInt32 *seed); 

Returns the seed for the application pattern table. The seed is updated when 
25 changes are made to the pattern table which may invalidate cached 
PixPatsHandles. 

SPI 

OSErr InstallSystemPatDef (SOMObject pattemDefObject); 
Installs a pattern definition in the system PatDef table. 

30 Having described two exemplary embodiments wherein pattem look- 

up tables can be used to abstract patterns and colors from the interface, 
another example is provided below in which both embodiments are applied 
to the exemplary application of filling a window rectangle with the bevel 
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background color and then drawing a bevel inset two pixels in the window. 

First, by way of the former, exemplary embodiment wherein drawing 

primitives are sent to the appearance management layer. 

Rect bevelRect; 
5 OSErr error; 

GetWindowRect (&bevelRect); 

// Fill window rectangle with bevel background 

error = ThemeFillRect (kBevelBackgroimd, &bevelRect); 

// make bevel inset 2 pixels from window edge 
10 InsetRect (&bevelRect, 2, 2); 

// Draw Bevel on background 

error == ThemeDrawBevel (&bevelRect, false); 

Now, using the latter exemplary embodiment wherein the appearance 

management layer returns a data stmcture to the client, 

15 Rect bevelRect; 
OSErr error; 

PixPatHandle hBackgroundPat; 

GetWindowRect (&bevelRect); 

// Get bevel background PixPat 
20 error == ThemeGetPartPixPat (kBevelBackground, &hBackgroundPat); 

// Fill window rectangle with bevel background 
if (error = = noErr) 

FillCRect (&bevelRect, hBackgroundPat); 

// make bevel inset 2 pixels from window edge 
25 InsetRect (&bevelRect, 2, 2); 

// Draw Bevel on background 

error = ThemeDrawBevel (&bevelRect, false); 

Of course, those skilled in the art will appreciate that all of the 
pseudocode examples provided herein are intended to be exemplary and 
30 illustrative in nature. 
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Themes and Theme Switching 

Having described exemplary systems and methods for abstracting the 
appearance and behavior of a user interface from its functionality using 
switchable drawing procedures and pattern look-up tables, the following 
5 description indicates how these capabilities can be used together to manifest 
sets of appearance and behavior attributes on a user interface which blend 
together to project a conmion theme. As described earlier, themes are 
coordinated designs of the interface elements which combine to create a 
distinct visual and audio environment on the display. According to one 

10 exemplary embodiment of the present invention, users can choose among 
different themes from, for example, an appearance control panel which can 
be activated on the desktop interface. An exemplary appearance control 
panel is illustrated as Figure 1 1 . 

In Figure 11, a pop-up, pull-down or drop-down menu 140 allows 

15 users to specify an overall appearance/behavior by selecting the theme to be 
installed. Beneath the theme setting box 140 to the left is an options area 
142 in which a user may select various options within each theme. For 
example, a user could specify a background color, a font and a highlight 
color. To the right of the options area 142, is a preview area 144 where 

20 exemplary interface elements of the theme currently selected in box 140 are 
shown so that a user can preview what the theme will look like before 
making a selection. Exemplary interface elements can include, for example, 
a desktop pattern, a menu bar and menu, an active window, and a dialog box 
with radio buttons, a checkbox, push buttons, and selected text. Using the 

25 appearance control panel, a user will be able to change the appearance of the 
desktop quickly and easily. 

However, some users may desire even more control over the 
appearance and behavior of their desktop interface. Thus, according to 
another exemplary embodiment of the present invention, the appearance 

30 control panel can provide user selectibility over all of the objects which can 
be displayed on the user interface. For example, the appearance control 
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panel could include a library of each type of interface object from which the 
user can select for inclusion in a user-defined theme. After selecting one of 
each the different types of interface objects, the user can be prompted for a 
theme name under which pointers to the appropriate drawing procedures and 
5 other information for realizing the selected objects can be stored. According 
to still further exemplary embodmients of the present invention, an 
appearance object editor can be provided wherein a user can create his or 
her own interface objects using a library of parts provided by the object 
editor. For example, each of the glyphs illustrated in Figure 5 can have a 

10 multitude of variations from which a user can create his or her own 
document window (both active and inactive). Once created, the new 
interface object can be stored in the library of interface objects from which 
user-defined themes can be created. 

Theme attributes are a collection of theme properties that are both 

15 system-defined and theme-defined. Each of the theme's properties can be 
queried and set by appearance management layer functions. For example, 
the following properties can be defined by the system: 

#define kThemeSystemFont 'sysf 
#defme kThemeTextHighlightColor 'tcol' 

20 To get a theme property, a get theme property function can be called for 
example by: 

OSErr GetThemeProperty (OSType property, void *dataptr. Size 
dataSize) 

This function will return the requested property from the current theme. If 
25 the current theme does not include the requested property, typeNotFoundErr 
is remmed. 

To set a theme property, call the SetThemeProperty function: 

OSErr SetThemeProperty (OSType property, void *dataptr. Size 
datasize) 
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The SetThemeProperty command sets the specified theme property to the 
given data. Having described tiiemes in general and ways in which themes 
can be created, selected and stored by a user, the following describes the 
operation of systems and methods according to the present invention once a 
5 theme change is requested by a user or an application beginning with 
Figure 12. 

Figure 12 illustrates interactions between, for example, a theme 70, 
the appearance management layer 40, and an application 38. Therein block 
48 includes the pattern tables as discussed above, and block 54 contains the 
10 animation and sound utilities which supplement the runtime routines of block 
52. Further, an icon 68 is shown which diagranMnatically illustrates an 
appearance control panel 69, e.g., the panel of Figure 10, which an end user 
can operate to switch themes. 

A current theme's resource chain 72 is opened and managed by the 

15 theme switching 50 and runtime, routines 52. The resource chain 72 can 

include, for example, a theme attributes property list (e.g., behavior matrices 
as described above), theme preferences (e.g., a preferred background 
pattern, preferred system font, etc.), theme data resources (e.g., the pattern 
table which defines the set of patterns and colors used by the theme, pattern 

20 code procedures which allow definition of new pattern types, etc.) and 

override resources (e.g., icons for the theme which overrides system icons). 
The theme resource chain can be maintained separately from the resources of 
the currently running application, and can be switched in and out in response 
to a demand by either an application or a user (appearance control panel). 

25 The theme's resource chain 72 is setup whenever the appearance 
management layer 40 calls any of the theme's code. 

As explained above with respect to the switchable drawing procedures 
according to exemplary embodiments of the present invention, when the 
appearance management layer is present, conventional drawing procedures 

30 (e.g., CDEF, LDEF, MDEF and WDEF) are replaced by the appearance 
management layer's switcher resources shown in Figure 11 at blocks 74-80. 
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Extemally, these switcher resources serve the identical function as traditional 
drawing procedures. Internally, they permit dynamic switching to the 
appropriate drawing procedures by the utilities when the theme changes. 
This switching can be accomplished by supplying new pointers 82-88 to the 
5 drawing procedures referenced by switcher resources 74-78. In this way, 
when the switcher resources call back into the utilities as described above, 
the utilities will be pointed at the drawing procedures for the current theme. 

The current theme is set by calling the appearance management 
layer's set theme function, for example, by the command: 

10 OSErr SetTheme (const FSSpec *themefile) 

The set theme function uses an FSSpec parameter that identifies the theme 
file that should be loaded and activated by the appearance management layer. 
In normal operation, fliis function loads the requested theme file, switches to 
the new theme and then releases the old theme. The old theme is released 

15 after the new theme is completely loaded so that if the new theme could not 
be activated, the system can revert back to the original theme such that the 
user does not become stranded without an interface. 

The exemplary steps illustrated in the flowchart of Figure 13 can be 
executed to open the new theme file. At block 100, a new theme info record 

20 is created. This data stmcture contains all of the global information that the 
appearance management layer uses to keep track of the state of the current 
theme and contains its own resource chain information, e.g., procedure 
pointer tables for the switcher, the theme property list, the theme pattern 
tables, etc. 

25 Next, the appearance management layer creates a new resource chain 

at block 102. The new theme's resource file is then opened at 104 after 
which the theme's runtime code is loaded, at 106, and its open function is 
called. At this time, the new theme can test the operating conditions of the 
system to determine if the load should continue or be aborted. If the load 

30 aborts, the theme may present an alert to the user as to why the theme could 
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not be loaded. If the theme has its own preferences file, it can be opened by 
the theme at this time. 

The theme's property list is loaded at block 108, for example, by 
calling a get resource function. This allows the property list to come from 
5 any preferences file that may have been opened in the previous step. If a 
property list is foimd, it is stored in the theme info record. Subsequently, at 
block 110, the theme's pattern look-up table is loaded. First, all pattern 
definition procedure resources are loaded. Then the standard pattern look-up 
table and part index table resources are loaded. The pattern look-up table is 

10 then built from the contents of these resources. A pointer table to be used 
by the switcher resources is then built as shown by block 112. This table is 
stored in the theme info record. Lastly, the new theme's initialize function 
is called at block 114. The new theme can allocate memory or load extra 
resources that it requires while being active. 

15 Figure 14 illustrates steps that can be executed to switch from an old 

theme to a new theme. First, a transition effect can be presented as block 
116. For example, the screen may fade to black, a dialog can be presented, 
or the themes could gradually blend from one to the other, e.g., 
"morphing". Then, the old theme's resource chain is switched in as 

20 described by block 118. All of the drawing procedures are called with a 
deallocate message. These messages 120 are sent to the appearance 
management layer's switcher definition procedures, which are currently 
routing messages to the old theme's implementations of the definition 
procedures. This allows any of the theme's definition functions to deallocate 

25 any global data that they may have been allocated. 

The appearance management layer sets the new theme info record as 
the current theme's information record at 122. Once the new theme info 
record is set, all of the external calls into the appearance management layer 
will affect the new theme. The new theme's resource chain is switched in at 

30 block 124. All of the drawing procedures are called with an initialize 
message. These messages are sent to the appearance management layer's 



wo 95/31775 



PCmJS95/06175 



- 39- 

switcher resources, which are currently routing messages to the new theme's 
implementations of the drawing procedures. This allows any of the theme's 
definition functions to allocate any global data that they may need. 

The steps executed to release the old theme file are shown in Figure 
5 15. First, at block 128, the old theme's resource chain is switched in. 
Next, the old theme's deallocate function is called at 130. The theme is 
responsible for disposing of any allocations that it may have made when it 
received its initialize message. The old pointer table used by the switcher 
definition procedures is disposed of per block 132. Then, the old theme's 

10 pattern look-up table and property list are disposed of as denoted by blocks 
134 and 136, respectively. The files in the old theme*s resource chain can 
then be closed and the resource chain disposed of prior to disposing of the 
old theme's theme info record G>Iocks 138 and 140), 

If an error occurs while trying to open and load the new theme or 

15 while switching from the old theme to the new theme, the switch is aborted 
and the set theme function attempts to reverse all of the steps that have 
already successfully completed so that the system continues to generate an 
interface using the old theme. The error that caused the switch to abort can 
be returned by this function. To request that the default system theme is 

20 switched in, either an FSSpec parameter to the system file or NIL can be 
passed in the themefile parameter. 

To determine what theme file is currently active, a get theme function 
can be called, for example by the command: 

OSErr GetTheme (FSSpec *currentThemeSpec) 

25 An FSSpec parameter value referencing the currently active theme file will 
be returned in the currentThemeSpec parameter. If the current theme is the 
default system theme, an FSSpec referencing the system file will be 
retumed. If an error occurs while attempting to locate the FSSpec of the 
current theme, an appropriate error code will be retumed and the 

30 currentThemeSpec parameter will remain unchanged. 
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Normally, the current theme's resource file is not present in the 
currently running application's resource chain. This can be done to prevent 
resource identification conflicts between applications, the operating system 
and the current theme. The appearance management layer maintains a 
5 separate resource chain that contains the current theme file and any other 
files that the current theme may have opened (such as a preferences file). 
When the appearance management layer executes code in the theme, the 
theme's resource chain is setup by the appearance management layer, which 
allows for normal GetResource calls to be used to get theme resources. If 

10 an application wishes to gain access to the current theme's resources, several 
functions can be provided. For example, to get a resource from the current 
theme file, a get theme resource function can be called, for example: 

Handle GetThemeResource (OSType restype, UIntl6 id) 
GetThemeResource has the same function as the GetResource function, 

15 except that this command gets the resource from the current theme's 
resource chain. 

If more flexibility is needed when getting resources from the current 
theme file, the low-level appearance management layer function 
GetThemeTopMapHandle may be used to get the top of the current theme's 

20 resource chain. 

OSErr GetThemeTopMapHandle (Handle *themeMap) 
The GetThemeTopMapHandle function returns the top map handle that 
contains the current theme file and any other opened theme files (such as a 
preferences file) and all of the system resource maps. Caution should be 

25 exercised when using the GetThemeTopMapHandle function to avoid leaving 
the theme's resource chain switched in when executing utility functions or 
after returning to other parts of an application's code. When the theme's 
resource chain is switched in, the application's resource chain is unavailable. 
Note also that when the theme changes, this map handle and associated 

30 resources will no longer be valid, so this value should not be cached. 



wo 95/31775 



PCTAJS95/06175 



-41 - 

A theme can implement three theme deHnition functions that the 
appearance management layer calls when a theme is being loaded or 
disposed of. When the appearance management layer begins to switch to a 
theme, inmiediately following that theme's resource file being opened, the 
5 theme's function can be called. 

pascal OSErr ThemeFilePreflight (void *themedata) 
The theme's test function is called before any resources are loaded by the 
appearance management layer. In this way, the theme has an opponunity to 
test the conditions of the operating system (such as memory or graphics 

10 capability). If the test function returns an error, the appearance management 
layer will close the theme file and not attempt to continue loading. If the 
test function returns no error, the appearance management layer continues to 
load the theme, as described above. 

The themedata parameter retumed by the exemplary test function 

15 shown above is used by the theme to allocate and store any global data that 
the theme wishes to keep for itself. On entry to the test function, the 
themedata parameter points to NIL. The test function (or any of the other 
theme definition functions) may change the value pointed to by themedata. 
This themedata value is persistent as long as the theme remains loaded. 

20 When the appearance management layer is finished loading all of the 

theine's resources and loading each of the theme's standard defmition 
procedures, the theme's initialize function is called, for example: 

pascal OSErr ThemeFilelnitialize (void *themedata) 
The theme's initialize function can be used to do any special processing after 

25 the appearance management layer has completely loaded the theme. It may 
allocate data stmctures, load additional resources, open preferences files, 
setup its theme property list, etc. The themedata parameter points to a 
global storage location useful for storing a pointer to the themes global data. 
If the theme's initialize function returns an error, the appearance 

30 management layer will abort the switch to the theme. The appearance 
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management layer will dispose of any allocations it has already made and 

close the theme file. 

When the appearance management layer is preparing to unload a 

theme» the theme's dispose function is called, for example: 
5 pascal OSErr ThemeFileDispose (void *themedata) 

The dispose function should dispose of any allocations that were made with 

either the test or initialize functions. The theme file then has an opportunity 

to store any resources in its preferences file and/or set its theme properties. 

After the theme returns from this function^ the appearance management layer 
10 will deallocate all of the appearance management layer's storage for the 

theme and close the theme's file. 

The above-described exemplary embodiments are intended to be 

illustrative in all respects, rather than restrictive, of the present invention. 

Thus the present invention is capable of many variations in detailed 
15 implementation that can be derived from the description contained herein by 

a person skilled in the art. All such variations and modifications are 

considered to be within the scope and spirit of the present invention as 

defined by the following claims. 
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WHAT IS CLAIMED IS : 

1. A graphical user interface comprising: 

a first set of interface objects whose individual appearances 
are associated with a first common theme; 
5 a second set of interface objects, each of which correspond in 

function to an associated interface object in said first set, but whose 
individual appearances are associated with a second common theme different 
from said first theme; and 

means for selectively changing between said first theme and 
10 said second theme, whereby said graphical user interface displays interface 
objects using one of said first set and said second set. 

2. The graphical user interface of claim 1, wherein said 
individual appearances of said interface objects are defined by appearance 
attributes of object parts which comprise said interface objects. 

15 3. The graphical user interface of claim 2, wherein said 

appearance attributes include size, shape, color, and location. 

4. The graphical user interface of claim 2, wherein said object 
parts include: zoom boxes, close boxes, sliders, checkboxes, bevels, 
separators, grouping boxes, disclosure triangles, buttons and scrollbars. 

20 5. The graphical user interface of claim 2, wherein at least one 

of said object parts which comprises one of said interface objects in said first 
set exhibits a first behavior which is different than a function attributable to 
said at least one of said object parts. 
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6. The graphical user interface of claim 5, wherein said at least 
one of said object parts is a close box, said first behavior is to become 
shaded and said function is to close a window object. 

7. The graphical user interface of claim 5, wherein an object part 
5 in said second set of interface objects which corresponds to said at least one 

object part and user actuation of which results in said function, exhibits a 
second behavior which is different than said first behavior. 

8. The graphical user interface of claim 1, further comprising: 
an effect generator which generates a transitional effect when 

10 said first theme is switched to said second theme. 

9. The graphical user interface of claim 1, wherein said means 
for selectively changing themes, comprises: 

a control panel which allows a user to selectively change 
between themes. 

15 10. The graphical user interface of claim 1, wherein said means 

for selectively changing themes further comprises: 

means for changing pointers from a first set of drawing 
procedures which correspond to said first theme to a second set of drawing 
procedures which correspond to a second theme. 

20 11. The graphical user interface of claim 1, wherein said means 

for selectively changing themes further comprises: 

means for supplying a set of data structures corresponding to 
said second theme to a set of parametric drawing procedures. 
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12. The graphical user interface of claim 1 further comprising: 
a pattern look-up table which abstracts color and pattern 

information of said interface objects from the interface itself. 

13. A method for graphically interfacing a user with a computer 
5 system comprising the steps of: 

displaying interface objects using an appearance for each 
associated with a first theme; 

changing a selected theme from said first theme to a second 

theme, and 

10 displaying, after said changing step, said interface objects 

using an appearance for each associated with said second theme. 

14. The method of claim 13, further comprising the steps of: 
defining said first theme by selecting appearance attributes for 

object parts of said interface objects that project a first common impression, 
15 and 

defining said second theme by selecting appearance attributes 
for object parts of said interface objects that project a second common 
impression. 

15. The method of claim 14, further comprising the step of: 

20 providing as said object parts at least one of: a zoom box, a 

close box, a slider, a checkbox, a bevel, a separator, a grouping box, a 
disclosure triangle, and a scrollbar. 

16. The method of claim 14 further comprising the steps of: 
exhibiting a first behavior and producing a resultant function 

25 when an object part of one of said interface objects is acmated while 

displaying said one of said interface objects using said appearance associated 
with said fu-st theme, and 
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exhibiting a second behavior and producing said resultant 
function when said object part of said one of said interface objects is 
actuated while displaying said one of said interface objects using said 
appearance associated with said second theme. 

5 17. The method of claim 16, wherein said step of exhibiting a first 

behavior and producing a resultant function comprises the step of: 
shading a close box and closing a window object. 

18. The method of claim 17, wherein said step of exhibiting a 
second behavior and producing said resultant function comprises the step of: 

10 drawing lines emanating from said close box and closing said 

window object. 

19. The method of claim 13 wherein said step of changing a 
selected theme further comprises the step of: 

displaying a control panel for inputting theme selections. 

15 20. The method of claim 13, further comprising the step of: 

generating a transitional effect prior to displaying said 
mterface objects using an appearance associated with said second theme. 

21. The method of claim 13, wherein said step of changing a 
selected theme further comprises the step of: 

20 changing pointers from a first set of drawing procedures which 

correspond to said first theme to a second set of drawing procedures which 
correspond to said second theme. 

22. The method of claim 13, wherein said step of changing a 
selected theme further comprises the step of: 
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supplying a set of data structures corresponding to said second 
theme to a set of parametric drawing procedures. 

23. A method for controlling an appearance of a user interface 
comprising the steps of: 
5 displaying interface objects in a first theme set until a second 

theme set is invoked and 

subsequently displaying said interface objects in a second 

theme set. 
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